Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Public Draw Context Methods

TQASetFloat

A drawing engine must define a method to set a floating-point value for a draw context state variable.

typedef void (*TQASetFloat) (
                             TQADrawContext *drawContext, 
                             TQATagFloat tag, 
                             float newValue);

drawContext

A draw context.

tag

A state variable tag.

newValue

The new value of the specified state variable.

DESCRIPTION

Your TQASetFloat function should set the value of the draw context state variable specified by the drawContext and tag parameters to the floating-point value specified by the newValue parameter.

Your drawing engine must accept all possible values for the tag parameter. If you encounter a value in the tag parameter that you cannot recognize, you should do nothing. Similarly, you should do nothing if the tag parameter specifies a state variable for optional features your drawing engine does not support.

SPECIAL CONSIDERATIONS

If your TQASetFloat function needs to change one or more of the function pointers in the specified draw context, it must call the QARegisterDrawMethod function to do so. It should not directly change the fields of a draw context.